home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / System / Menu / Menu Bar Utilities / OtherMenu 1.2.3 / OtherMenu Manual < prev   
Text File  |  1993-08-29  |  10KB  |  144 lines

  1.     
  2.  
  3.  
  4.  
  5.  
  6.  
  7. © 1992, 1993 by James W. Walker, all rights reserved.
  8.  
  9. OtherMenu is an extension that creates a system-wide hierarchical menu somewhat similar to the Apple menu.  It can be used for launching applications and documents, restart and shut down, various file management functions, and executing FKEYs.  It requires System 7.  OtherMenu takes up a minimum of about 14K of system memory, but uses more depending on the length of the menu and the number of submenus.
  10.  
  11. The first time you start your Mac with OtherMenu installed, OtherMenu creates a folder named OtherMenu Folder inside your System Folder.  You will see a menu whose title is a round icon near the help menu.  Initially, the menu will contain only one item, “About OtherMenu…”, which can be used to read this documentation.
  12.  
  13.  
  14. Operation    
  15.  
  16. Release the mouse button over any menu item.  Applications, documents, control panels and desk accessories are launched.  Folders are opened in Finder.  FKEYs and OtherMenu externals are executed.
  17.  
  18.  
  19. Configuration    
  20.  
  21. The contents of OtherMenu’s menu is determined by the contents of the OtherMenu Folder, just as the contents of the Apple menu is determined by the contents of the Apple Menu Items folder.  All files and aliases placed in the OtherMenu Folder become OtherMenu menu items.  And unlike the Apple menu, you can put in folders, and aliases of folders and volumes, to create submenus up to 5 levels deep.
  22.  
  23. You can modify the order of menu items by adding special characters to the beginnings of their names.  The first ordinary character in the Macintosh character set, the space, is particularly useful.  I also like ◊, or shift-option-v, which comes very late in the order.  Do not begin a file name with a period.  To make a dividing line in the menu, create a folder with any name ending in “-***”.
  24.  
  25. OtherMenu’s menu will appear just as the contents of the OtherMenu Folder appear in “Name” view in Finder, alphabetically, by level.  For example, if the contents of the OtherMenu Folder look like this,
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44. then the menu will look like this:
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. If you select “About OtherMenu” with the shift key held down, you will see a dialog that controls several settings.  Changes in the upper group only take effect at startup.  The Startup Icon checkbox determines whether OtherMenu displays an icon during the startup process.  The “Size of menu cache” control determines how many submenus will be cached; higher values get you speedier response at the expense of some system memory.  The three radio button determine where the menu will appear: to the left of the help menu, just left of the application menu, or to the right of the application menu.
  67.  
  68.   The lower group of settings take effect immediately.  The “Warn on launch in tight memory” option shows a warning dialog if you launch an application when there is not enough memory to give the application its preferred amount; if this is not checked, the application may be launched in its minimum amount of memory without warning.  If you uncheck “Menu title is an icon” then the menu title becomes “Other”.  The remaining controls affect the behavior of submenus, and they affect all software, not just OtherMenu.  The “appearance delay” allows you to drag down a menu without submenus appearing and disappearing as you go past them, and the “drag delay” allows you to drag diagonally from a menu item to an item on a submenu without the submenu disappearing too quickly.  These delays are the same parameters affected by Carlos Weber’s  MenuTuner control panel, but OtherMenu maintains the new values actively instead of changing the standard values in PRAM.  The numbers are in units of 1/60 seconds.  Note that since the changes take effect immediately, you can try them out on the menu before dismissing the dialog.
  69.  
  70.  
  71. OtherMenu Externals    
  72.  
  73. OtherMenu has code modules, similar to FKEYs, of file type '*Cmd', '*CMD', or '*Sub'.  They use system memory and can be placed in the menu and executed with less overhead than applications.  '*Sub's have their own submenus, while the other types do not.  You need not install the full set of externals.  If you hold the shift key while selecting an external, it will display an About box, which can allow for adjustment of settings, or might just show the version number.  If you are a programmer, you can write your own externals.  Sample code is available as a separate “OtherMenu Developer Kit” from some of the same sources as OtherMenu, such as CompuServe, America Online, and bigbird.csd.scarolina.edu.
  74.  
  75.  
  76. About FKEYs    
  77.  
  78. An FKEY is a small program without a full user interface that performs a simple task and quits.  When you press command-shift-3 to take a screen snapshot, you are executing an FKEY installed in the System file.  You can place FKEY files, and aliases to FKEY files, in the OtherMenu Folder, and use the menu to execute them.  Such files should have file type 'FKEY', and contain exactly one resource of type 'FKEY', plus possibly resources of other types.
  79.  
  80.  
  81. Modal Dialogs    
  82.  
  83. Usually, you don't have much freedom of action when the front window is a modal dialog.  You know, the kind of window that has a border like this:
  84.  
  85.  
  86.  
  87.  
  88.  
  89. You can’t switch to another application, and you can’t even switch to another window within the same application.  Yet, you can use OtherMenu to execute externals and FKEYs while a modal dialog is showing.  This freedom entails some risk, because the programmers who wrote your applications and other extensions probably didn’t anticipate that you could do such a thing.  In fact my own programs Open-wide and Dialog View were only recently made compatible with showing a directory dialog on top of another directory dialog.
  90.  
  91.  
  92. Directory Dialogs    
  93.  
  94. Directory dialogs (Open and Save dialogs) are a special kind of modal dialog, and as such the previous section applies to them.  However, OtherMenu has another use within these dialogs:  You can use OtherMenu to select a folder to be displayed in the directory dialog.  In the case of Open dialogs, you can select a file (other than an external or FKEY) to make that file become selected in the Open dialog.  If OtherMenu fails to select the file you asked it to select, it will beep.  This can happen if you select a file that is not the right type for that Open dialog, or if the folder contains many files that start with the same letter.  The “rebound” feature in Super Boomerang or similar utilities may interfere with file selection, but not folder selection.
  95.  
  96.  
  97. Tips For Running OtherMenu    
  98.  
  99. In some cases, there may not be enough room on the menu bar for all of an application’s menus plus the system menus.  OtherMenu will be the first to disappear.  You may want to use a utility such as MICN or Cram Bar (freeware) or Menuette (shareware) to lessen menu-bar crowding.
  100.  
  101. OtherMenu launches files other than applications, desk accessories, FKEYs, and OtherMenu externals by telling Finder to open the file.  When this happens, Finder will momentarily come to the foreground.  If there is not enough memory to open the file, Finder will display an alert box telling you about the problem.
  102.  
  103. Many of the functions of OtherMenu and its externals require that Finder be running.   OtherMenu can launch applications (including Finder itself), but not documents, when Finder is not running.
  104.  
  105. Before you ask:  No, you can’t assign keyboard equivalents to items in OtherMenu’s menu, even with QuicKeys.
  106.  
  107.  
  108. Shareware Fee    
  109.  
  110. The shareware registration fee for OtherMenu is US$10 per copy.  An individual with several computers need only pay for one copy.  Please pay by personal check, international postal money order, or cash in U.S. funds, sent to the address listed below.  (I understand that it is illegal to mail cash in some countries, but not in the U.S.)  When you register, tell me your e-mail address if you have one.
  111.  
  112. James W. Walker
  113. 3200 Heyward Street
  114. Columbia, SC 29205
  115.  
  116. CompuServe users can register online.  GO SWREG; the ID is 1208.
  117.  
  118. I do not claim that I can or will enforce the shareware fee.  But the more payments I receive, the more likely I am to make further enhancements to OtherMenu.  If you have any feature requests, I will be much more likely to listen to you if you have paid.
  119.  
  120. For a separate fee of US $5, registered users may request a disk containing the latest version of the OtherMenu software.  I will send an 800K disk unless you tell me that you need the new 720K format.
  121.  
  122.  
  123. Distribution    
  124.  
  125. OtherMenu may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author.  The author’s failure to give permission promptly should not be taken as consent.   Companies that distribute public domain/freeware/shareware software for profit are expressly prohibited from distributing OtherMenu.  This restriction does not apply to bulletin boards, commercial on-line services such as America Online, CompuServe and GEnie, and nonprofit Macintosh user groups which hold regularly scheduled public meetings.
  126.  
  127.  
  128. No warranty    
  129.  
  130. OtherMenu uses some undocumented techniques.  Use it at your own risk.
  131.  
  132.  
  133. Author’s address    
  134.  
  135. I can be reached by e-mail at the following addresses.  For a regular mail address, see the Shareware section above.
  136.  
  137. CompuServe: 76367,2271
  138. America Online: JWWalker
  139. Internet: walkerj@math.scarolina.edu
  140.  
  141.  
  142. Acknowledgements    
  143.  
  144. Thanks to Susan Lesch for helpful feedback, testing, and user interface assistance during the development of OtherMenu, and to Leonard Rosenthol for programming tips and assistance with some externals.